Configuration

Solr prend en charge les installations à un ou plusieurs nœuds :

  • Une installation à nœud unique désigne une instance unique de Solr fonctionnant sur un serveur, avec toutes les informations d’indexation maintenues dans l’instance unique.
  • Une installation multi-nœuds consiste en deux ou plusieurs instances de Solr exécutées sur des serveurs différents, les informations d’indexation étant réparties sur toutes les instances.

La configuration et la maintenance d’installations multi-nœuds sont complexes et prennent du temps. Elles ne sont généralement nécessaires que lorsque la quantité de données indexées est de l’ordre de plusieurs centaines de gigaoctets. Dans la plupart des cas, la quantité d’informations d’indexation requise par EMu ne nécessite qu’une configuration à nœud unique.

Dans un souci de simplicité et pour réduire la latence du réseau, il est recommandé que Solr tourne sur le même serveur que le système EMu. Les instructions suivantes décrivent comment configurer un tel système :

Pour configurer le support d’indexation Solr pour EMu sur FreeBSD :

  1. Connectez-vous en tant que root
  2. Saisissez pkg install apache-solr
  3. Saisissez vi /etc/rc.conf
  4. Ajoutez solr_enable="YES" au fichier et enregistrez-le.
  5. Exécutez grep emuadmin /etc/group et notez le numéro de groupe.
  6. Saisissez vipw et remplacez le numéro du groupe de connexion de l’utilisateur solr par emuadmin.
  7. Saisissez vi /usr/local/etc/solr.in.sh
  8. Recherchez le paramètre pour SOLR_JAVA_MEM.

    Retirez le commentaire et modifiez la quantité de mémoire allouée à Solr à environ 25 % de la mémoire du système.

    Par exemple, pour autoriser 8 Go de mémoire pour Solr, utilisez le paramètre suivant :

    SOLR_JAVA_MEM="-Xms8g -Xmx8g"

  9. Ajoutez la ligne suivante au bas du fichier :

    SOLR_OPTS="$SOLR_OPTS -Dsolr.max.booleanClauses=500000"

  10. Sauvegardez le fichier et quittez l’éditeur.
  11. Saisissez vi /var/db/solr/solr.xml
  12. Ajoutez la ligne suivante à l’intérieur de la balise <solr> :

    <str name="coreRootDirectory">/home/emu</str>

    où la valeur de coreRootDirectory doit être le répertoire personnel de emu de l’utilisateur.

  13. Sauvegardez le fichier et quittez l’éditeur.
  14. Saisissez service solr start

Vous pouvez vérifier si Solr est opérationnel en accédant au site d’administration de Solr à l’adresse http://localhost:8983/solr. Le nom d’hôte du serveur EMu (ou l’adresse IP) peut être utilisé à la place de localhost si vous naviguez depuis une autre machine.

Solr est maintenant opérationnel et prêt à être utilisé par EMu.

Note: Solr n’est pas disponible dans les dépôts amont de RedHat et CentOS ; il est nécessaire de le télécharger et de l’installer manuellement.

Pour configurer le support d’indexation Solr pour EMu sur RedHat ou CentOS :

  1. Rendez-vous sur https://solr.apache.org/downloads.html et cliquez sur le lien de la dernière version binaire de Solr.

    La page de téléchargement de la version s’affiche.

  2. Copiez l’URL du site de téléchargement suggéré, par exemple :

    https://dlcdn.apache.org/lucene/solr/{version}/solr-{version}.tgz

  3. Connectez-vous en tant que root
  4. Saisissez cd /tmp
  5. Saisissez wget {URL of latest Solr binary download}
  6. Saisissez tar xzf solr-{version}.tgz solr-{version}/bin/install_solr_service.sh --strip-components=2
  7. Saisissez ./install_solr_service.sh solr-{version}.tgz

    Solr procède maintenant à l’installation.

  8. Saisissez chown -R solr:solr /opt/solr-{version}
  9. Saisissez chmod 644 /etc/default/solr.in.sh
  10. Exécutez grep emuadmin /etc/group et notez le numéro de groupe.
  11. Saisissez vipw et remplacez le numéro du groupe de connexion de l’utilisateur solr par emuadmin.
  12. Saisissez vi /etc/default/solr.in.sh
  13. Recherchez le paramètre pour SOLR_JAVA_MEM.

    Retirez le commentaire et modifiez la quantité de mémoire allouée à Solr à environ 25 % de la mémoire du système.

    Par exemple, pour autoriser 8 Go de mémoire pour Solr, utilisez le paramètre suivant :

    SOLR_JAVA_MEM="-Xms8g -Xmx8g"

  14. Ajoutez la ligne suivante au bas du fichier :

    SOLR_OPTS="$SOLR_OPTS -Dsolr.max.booleanClauses=500000"

  15. Sauvegardez le fichier et quittez l’éditeur.
  16. Saisissez vi /var/solr/data/solr.xml
  17. Ajoutez la ligne suivante à l’intérieur de la balise <solr> :

    <str name="coreRootDirectory">/home/emu</str>

    où la valeur de coreRootDirectory doit être le répertoire personnel de emu de l’utilisateur.

  18. Sauvegardez le fichier et quittez l’éditeur.
  19. Saisissez systemctl stop solr
  20. Saisissez systemctl start solr
  21. Saisissez systemctl status solr

Vous pouvez vérifier si Solr est opérationnel en accédant au site d’administration de Solr à l’adresse http://localhost:8983/solr. Le nom d’hôte du serveur EMu (ou l’adresse IP) peut être utilisé à la place de localhost si vous naviguez depuis une autre machine.

Solr est maintenant opérationnel et prêt à être utilisé par EMu.